<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!-- saved from url=(0201)http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#æ ¹æ®ç»éè´¦å·åå¯ç è·åå¶æ¯ç®¡çåçå·¥ä½ååè¡¨_å¼åèé´æä¸åæ¬è¯¥æ¥å£ -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh" lang="zh" dir="ltr"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

<title>open:组织人员同步 - 云之家·开放平台</title>
<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" /><![endif]-->
<meta name="generator" content="DokuWiki">
<meta name="robots" content="index,follow">
<meta name="date" content="2016-03-18T10:40:59+0800">
<meta name="keywords" content="open,组织人员同步">
<link rel="search" type="application/opensearchdescription+xml" href="http://open.kdweibo.com/wiki/lib/exe/opensearch.php" title="云之家·开放平台">
<link rel="start" href="http://open.kdweibo.com/wiki/">
<link rel="contents" href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5&do=index" title="网站地图">
<link rel="alternate" type="application/rss+xml" title="最近更改" href="http://open.kdweibo.com/wiki/feed.php">
<link rel="alternate" type="application/rss+xml" title="当前命名空间" href="http://open.kdweibo.com/wiki/feed.php?mode=list&ns=open">
<link rel="alternate" type="text/html" title="Plain HTML" href="http://open.kdweibo.com/wiki/doku.php?do=export_xhtml&id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5">
<link rel="alternate" type="text/plain" title="Wiki Markup" href="http://open.kdweibo.com/wiki/doku.php?do=export_raw&id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5">
<link rel="canonical" href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5">
<link rel="stylesheet" type="text/css" href="./open 组织人员同步 - 云之家·开放平台_files/css.php">
<link rel="stylesheet" type="text/css" href="./open 组织人员同步 - 云之家·开放平台_files/shCore.css">
<link rel="stylesheet" type="text/css" href="./open 组织人员同步 - 云之家·开放平台_files/shThemeEclipse.css">
<script type="text/javascript">/*<![CDATA[*/var NS='open';var JSINFO = {"id":"open:\u7ec4\u7ec7\u4eba\u5458\u540c\u6b65","namespace":"open"};
/*!]]>*/</script>
<script type="text/javascript" charset="utf-8" src="./open 组织人员同步 - 云之家·开放平台_files/js.php"></script>
<script type="text/javascript" src="./open 组织人员同步 - 云之家·开放平台_files/shCore.js"></script>
<script type="text/javascript" src="./open 组织人员同步 - 云之家·开放平台_files/shAutoloader.js"></script>
<script type="text/javascript" src="./open 组织人员同步 - 云之家·开放平台_files/shBrushXml.js"></script>
<script type="text/javascript" src="./open 组织人员同步 - 云之家·开放平台_files/inlinetoc.js"></script>
<meta name="viewport" content="width=device-width,initial-scale=1">
<link rel="shortcut icon" href="http://open.kdweibo.com/wiki/lib/tpl/mnml-blog/images/favicon.ico">
<link rel="apple-touch-icon" href="http://open.kdweibo.com/wiki/lib/tpl/mnml-blog/images/apple-touch-icon.png">
<script type="text/javascript" charset="utf-8" src="./open 组织人员同步 - 云之家·开放平台_files/user.js"></script>
<!--[if lte IE 8]><link rel="stylesheet" media="all" type="text/css" href="/wiki/lib/tpl/mnml-blog/css/mnml-blog_screen_iehacks.css" /><![endif]-->
<!--[if lt IE 7]><style type="text/css">img { behavior: url(/wiki/lib/tpl/mnml-blog/js/iepngfix/iepngfix.htc); }</style><![endif]-->
<style type="text/css"></style></head>

<body youdao="bind">
<div id="pagewrap">

    <!-- start header -->
    <div id="tmpl_header">
        <a href="http://open.kdweibo.com/wiki/" name="dokuwiki__top" id="dokuwiki__top" accesskey="h" class="tmpl_header_logo_txt"><img src="./open 组织人员同步 - 云之家·开放平台_files/logo.png" id="tmpl_header_logo_img" alt="">&nbsp;&nbsp;云之家·开放平台</a>
        <div class="clearer"></div>
    </div>
    <!-- end header -->


    <!-- start main content area -->
    <div class="dokuwiki">
        
        <!-- start left col -->
        <div id="content">
           <div class="page">


<!-- start rendered page content -->

<p>
 </p><div class="inlinetoc"><!-- TOC START -->
<div id="dw__toc">
<h3 class="toggle open" style="cursor: pointer;"><strong><span>−</span></strong>目录</h3>
<div style="">

<ul class="toc" aria-expanded="true" style="">
<li class="level1"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#组织与人员同步api接口规范">组织与人员同步API接口规范</a></div></li>
<li class="level1"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#概述">1、概述</a></div>
<ul class="toc">
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#最新版本">1.1、最新版本</a></div></li>
</ul>
</li>
<li class="level1"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#网络传输协议规范">2、网络传输协议规范</a></div>
<ul class="toc">
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#网络传输协议">2.1、网络传输协议</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#http请求地址">2.2、HTTP请求地址</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#http请求方法">2.3、HTTP请求方法</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#http内容类型">2.4、HTTP内容类型</a></div></li>
</ul>
</li>
<li class="level1"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入与输出格式规范">3、输入与输出格式规范</a></div>
<ul class="toc">
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式">3.1、输入格式</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式">3.2、输出格式</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入参数加密算法">3.3、输入参数加密算法</a></div></li>
</ul>
</li>
<li class="level1"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#接口">4、接口</a></div>
<ul class="toc">
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#新增组织">4.1、新增组织</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#更新组织">4.2、更新组织</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#删除组织">4.3、删除组织</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#查询全部组织信息">4.4、查询全部组织信息</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#新增人员">4.5、新增人员</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#更新人员信息">4.6、更新人员信息</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#更新人员组织">4.7、更新人员组织</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#更新人员状态">4.8、更新人员状态</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#删除人员">4.9、删除人员</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#查询全部人员信息">4.10、查询全部人员信息</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#查询已更新人员信息">4.11、查询已更新人员信息</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#查询指定人员信息">4.12、查询指定人员信息</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#设置或取消管理员">4.13、设置或取消管理员</a></div></li>
<li class="level2"><div class="li"><a href="./open 组织人员同步 - 云之家·开放平台_files/open 组织人员同步 - 云之家·开放平台.html">4.14、根据登陆账号和密码获取其是管理员的工作圈列表（开发者鉴权不包括该接口）</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#创建公司_工作圈">4.15、创建公司（工作圈）</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#设置登陆mcloud公司_工作圈_的密码">4.16、设置登陆mcloud公司（工作圈）的密码</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#批量设置部门负责人">4.17、批量设置部门负责人</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#查询所有部门负责人">4.18、查询所有部门负责人</a></div></li>
<li class="level2"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#批量删除部门负责人">4.19、批量删除部门负责人</a></div></li>
</ul>
</li>
<li class="level1"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#错误码_消息码">5、错误码（消息码）</a></div></li>
<li class="level1"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#版本修订记录">6、版本修订记录</a></div></li>
<li class="level1"><div class="li"><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#discussion__section">评论</a></div></li>
</ul>
</div>
</div>
<!-- TOC END -->
</div>
<p></p>

<h1 class="sectionedit1" id="组织与人员同步api接口规范">组织与人员同步API接口规范</h1>
<div class="level1">

</div>

<h1 class="sectionedit2" id="概述">1、概述</h1>
<div class="level1">

<p>
本规范定义了云之家组织与人员同步的接口API
</p>

</div>

<h2 class="sectionedit3" id="最新版本">1.1、最新版本</h2>
<div class="level2">

<p>
当前最新版本：V2.5，详细版本修订记录请参见[ <a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#版本修订记录" title="open:组织人员同步 ↵" class="wikilink1">6、版本修订记录</a> ]
</p>

</div>

<h1 class="sectionedit4" id="网络传输协议规范">2、网络传输协议规范</h1>
<div class="level1">

</div>

<h2 class="sectionedit5" id="网络传输协议">2.1、网络传输协议</h2>
<div class="level2">
<pre class="code">使用HTTP协议进行信息传输</pre>

</div>

<h2 class="sectionedit6" id="http请求地址">2.2、HTTP请求地址</h2>
<div class="level2">
<pre class="code">http://mcloud.kingdee.com</pre>

</div>

<h2 class="sectionedit7" id="http请求方法">2.3、HTTP请求方法</h2>
<div class="level2">
<pre class="code">使用POST方法进行请求</pre>

</div>

<h2 class="sectionedit8" id="http内容类型">2.4、HTTP内容类型</h2>
<div class="level2">
<pre class="code">Content-Type: application/x-www-form-urlencoded</pre>

</div>

<h1 class="sectionedit9" id="输入与输出格式规范">3、输入与输出格式规范</h1>
<div class="level1">

</div>

<h2 class="sectionedit10" id="输入格式">3.1、输入格式</h2>
<div class="level2">

<p>
默认的输入字符编码格式为UTF-8格式
</p>

<p>
输入参数说明：
</p>
<pre class="code">nonce:string,				//校验重复请求,格式为16位以内随机字符串
eid:string,				//注册号,格式为字符串
data:string				//业务数据,格式为BASE64编码的字符串,编码前的内容须加密处理</pre>
<div class="wrap_center wrap_round wrap_info plugin_wrap" style="width:80%;">
<p>
注册号：创建工作圈时产生的唯一标识符，可简称为eid或mid
</p>

<p>
创建人在创建工作圈后会收到短信通知注册号及初始密码，创建人可登录<a href="http://mcloud.kingdee.com/" class="urlextern" title="http://mcloud.kingdee.com" rel="nofollow">企业云服务平台</a>修改初始密码
</p>
</div>
<p>
<strong>特别注意</strong>：后续所有接口（除非特别说明），请求的基本格式都是这样的。不同的接口，data部分使用对应业务json的加密串（json→string→加密→base64）。（<a href="https://github.com/yunzhijia/erp-demo" class="urlextern" title="https://github.com/yunzhijia/erp-demo" rel="nofollow">Java版示例程序</a>）
</p>

</div>

<h2 class="sectionedit13" id="输出格式">3.2、输出格式</h2>
<div class="level2">

<p>
默认的输出字符编码格式为UTF-8格式
</p>

<p>
输出内容的数据类型包括：
</p>
<ul>
<li class="level1"><div class="li"> 普通列表项目布尔型(Boolean),例如isNew:true|false</div>
</li>
<li class="level1"><div class="li"> 数字型(Number),例如number:3.1415</div>
</li>
<li class="level1"><div class="li"> 字符串型(String),例如name:'张三'</div>
</li>
<li class="level1"><div class="li"> 对象类型(Object),null表示空对象，{…}表示非空对象，对象的属性可以是Boolean, Number, String, Object, Array</div>
</li>
<li class="level1"><div class="li"> 数组类型(Array)：[]表示空数组。数组的元素可以是Boolean, Number, String, Object, Array</div>
</li>
</ul>

<p>
通用输出值的格式为JSON格式：
</p>
<pre class="code">{
	success: boolean,		//服务出现异常为false,其他为true
	error:string,			//错误信息,success=false时携带此信息
	errorCode:int,			//错误代码,用于错误的分类
	data: Object/Array		//返回值,类似Map对象或者Array数组对象
}</pre>

<p>
对于返回的结果，有以下几种情况：
</p>
<ol>
<li class="level1"><div class="li"> success=true: 成功，此时error=null、errorCode=0，代表没有错误。其中data为返回的数据对象，data只可能是Object或Array类型</div>
</li>
<li class="level1"><div class="li"> success=false: 失败，进一步查看errorCode确定错误的分类以确定下一步操作，对于每个接口来说，errorCode的情况可能都不一样，具体说明见各个接口的说明，确认错误类型后可查看data数据了解详细错误原因</div>
</li>
<li class="level1"><div class="li"> 批量处理只返回错误信息，无错误返回的表示导入成功</div>
</li>
</ol>

</div>

<h2 class="sectionedit14" id="输入参数加密算法">3.3、输入参数加密算法</h2>
<div class="level2">

<p>
输入参数中的data参数须使用企业私钥(Key)加密，企业管理员可在<a href="http://mcloud.kingdee.com/" class="urlextern" title="http://mcloud.kingdee.com" rel="nofollow">企业云服务平台</a>下载企业私钥（即RSA加密的私钥）。登录<a href="http://mcloud.kingdee.com/" class="urlextern" title="http://mcloud.kingdee.com" rel="nofollow">http://mcloud.kingdee.com</a>在企业信息管理—EMP 授权Key—下载，得到一个XXXX.key，它是一个二进制流文件，直接将文件读取到一个byte数组。还原RSA加密私钥的方法如下：
</p>
<pre class="code">public static PrivateKey restorePrivateKey(byte[] bytes) throws Exception {
	PKCS8EncodedKeySpec pkcs = new PKCS8EncodedKeySpec(bytes);
	KeyFactory kf = KeyFactory.getInstance("RSA");
	return kf.generatePrivate(pkcs);
}</pre>

<p>
java代码加密方法如下（此处使用的Key即上一步得到的RSA私钥，PrivateKey是Key的子类），不同实现语言请确保算法一致性:
</p>
<pre class="code">import java.security.Key;
import java.security.SecureRandom;
import java.security.Security;

import javax.crypto.spec.SecretKeySpec;

import org.bouncycastle.jce.provider.BouncyCastleProvider;

public class EncryptUtils {
	
	private static final String CIPHER_RSA = "RSA/ECB/PKCS1Padding";
	private static final String CIPHER_AES = "AES/ECB/PKCS5Padding";
	
	static{
		Security.addProvider(new BouncyCastleProvider()); 
	}
	
	public static byte[] encryptLarger(byte[] data, Key key) throws Exception {
		javax.crypto.Cipher rsa = javax.crypto.Cipher.getInstance(CIPHER_RSA);
		rsa.init(javax.crypto.Cipher.ENCRYPT_MODE, key);
		SecureRandom random = new SecureRandom();
		final byte[] secretKey = new byte[16];
		random.nextBytes(secretKey);
		final javax.crypto.Cipher aes = javax.crypto.Cipher.getInstance(CIPHER_AES);
		SecretKeySpec k = new SecretKeySpec(secretKey, "AES");
		aes.init(javax.crypto.Cipher.ENCRYPT_MODE, k);
		final byte[] ciphedKey = rsa.doFinal(secretKey);
		final byte[] ciphedData = aes.doFinal(data);
		byte[] result = new byte[128 + ciphedData.length];
		System.arraycopy(ciphedKey, 0, result, 0, 128);
		System.arraycopy(ciphedData, 0, result, 128, ciphedData.length);
		return result;
	}
}</pre>

<p>
注意：
使用非Sun JDK或者其它语言的开发者，JDK标准加密算法使用：AES/ECB/PKCS5Padding，其中，AES 的加密模式为：ECB，填充对齐方式：PKCS5Padding 。
</p>

<p>
加密方法提供者，使用第三方开源bouncycastle库，开发者请到：
</p>

<p>
<a href="https://www.bouncycastle.org/" class="urlextern" title="https://www.bouncycastle.org/" rel="nofollow">https://www.bouncycastle.org/</a>
</p>

<p>
查找对应版本的开发库（目前支持Java、C#平台）。
</p>

<p>
IBM JDK 由于默认不允许使用RSA私钥加密，为保持和SUN JDK的兼容性，请在运行时，添加JVM参数： 
</p>
<pre class="code">-Dcom.ibm.crypto.provider.DoRSATypeChecking=false</pre>

<p>
加密过程示意图：
<a href="http://open.kdweibo.com/wiki/lib/exe/detail.php?id=open%3A%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5&media=open:%E5%8A%A0%E5%AF%86%E6%B5%81%E7%A8%8Bpng.png" class="media" title="open:加密流程png.png"><img src="./open 组织人员同步 - 云之家·开放平台_files/fetch.php" class="media" alt="" width="200"></a>
</p>

</div>

<h1 class="sectionedit15" id="接口">4、接口</h1>
<div class="level1">
<div class="wrap_center wrap_round wrap_info plugin_wrap" style="width:80%;">
<p>
组织长名称：根据组织层级包含本组织及所有上级组织的完整名称，它具有以下特点:
</p>
<ol>
<li class="level1"><div class="li"> 组织长名称在工作圈中具有唯一性</div>
</li>
<li class="level1"><div class="li"> 组织长名称中的各级组织以”\”为分隔符</div>
</li>
<li class="level1"><div class="li"> 组织长名称前不能包含工作圈名称</div>
</li>
</ol>

<p>
例如: “研发中心\移动平台产品部\开发部”
</p>
</div>
</div>

<h2 class="sectionedit18" id="新增组织">4.1、新增组织</h2>
<div class="level2">
<div class="wrap_center wrap_round wrap_tip plugin_wrap" style="width:80%;">
<p>
新增组织是V2.0定义的新接口
</p>
</div>
<p>
描述: 新增组织，每次新增记录不超过1000条
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/dept/add
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{		
	eid:String,			//不必须，如果没有，则以外面的eid参数为准
	departments:[string,…]          //必填，组织长名称数组					
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，如果组织全部创建成功，则data里返回[]，如果有未创建成功的，则data中会有未创建成功的记录的具体信息，具体data格式:
</p>
<pre class="code">{
	[{
		msgId:string,		//组织长名称
		msgCode:int,		//消息码
		msg:string		//消息
	},…]	
}</pre>

</div>

<h2 class="sectionedit21" id="更新组织">4.2、更新组织</h2>
<div class="level2">

<p>
描述: 更新组织名称，每次更新记录不超过1000条
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/dept/update
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{		
	eid:string			//不必须，如果没有，则以外面的eid参数为准
	departments:[{
		department:string	//必填,原组织长名称
		todepartment:string	//必填,新组织长名称,路径中不存在的组织将会自动创建
	},...]					
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，如果更新组织全部成功，则data里返回[]，如果有未修改成功的，则未成功的记录会在data中会有具体错误信息，具体data格式:
</p>
<pre class="code">{ 
	[{
		msgId:string,		//原组织长名称
		msgCode:int		//消息码
		msg:string		//消息
	},…]	
}</pre>

</div>

<h2 class="sectionedit22" id="删除组织">4.3、删除组织</h2>
<div class="level2">

<p>
描述: 根据组织长名称删除组织，如该组织及其子组织下存在“正常”的人员，则删除失败；
</p>
<pre class="code">    若不存在“正常”的人员，则该组织及其子组织会被删除，同时把组织下“禁用”或“注销”的人员改为待分配状态</pre>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/dept/delete
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{		
	eid:string			//不必须，如果没有，则以外面的eid参数为准
	departments:[string,…]		//必填,要删除的组织长名称数组
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data格式:
</p>
<pre class="code">{ 
	[{
		msgId:string,		//组织长名称
		msgCode:int		//消息码
		msg:string		//消息
	},…]	
}</pre>

</div>

<h2 class="sectionedit23" id="查询全部组织信息">4.4、查询全部组织信息</h2>
<div class="level2">

<p>
描述: 查询全部人员信息
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/dept/getall
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	eid:string			//必填,注册号
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data格式:
</p>
<pre class="code">[{		    			//组织列表
	id:string			//组织的id
	parentId:string,		//组织父Id
	name:string,	    	        //组织名称
	depertment:string,		//组织长名称
},…]</pre>

</div>

<h2 class="sectionedit24" id="新增人员">4.5、新增人员</h2>
<div class="level2">
<div class="wrap_center wrap_round wrap_tip plugin_wrap" style="width:80%;">
<p>
新增组织是V2.0定义的新接口
</p>
</div>
<p>
描述: 每次新增数不能超过1000条。如果account中的账号传了密码，则改用户会自动激活，如果没传，则需要用户自行在手机端或网站上激活
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/person/add
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	eid:string			//不必须，如果没有，则以外面的eid参数为准
	persons:[{		    	//必填,人员列表
		name:string,		//必填,姓名
		photoUrl:string,	//可选,头像URL,可访问的公网URL,默认为空
                account:{
                     mobile:String      //可选，手机账号。如果account中的email为空，且下面phone字段也为空，那mobile字段就必须，否则创建账号不成功。
                                          如果有mobile字段，也有下面phone字段，则优先以mobile字段作为账号,phone忽略。
                                          建议下面phone和mobile只要其中一个传值即可
                     email:String       //可选，邮箱账号
                     password:String    //可选，账号密码，如果传了该密码，则账号会激活，如果没传，则是未激活的账号，需要该用户自行激活
                }
		phone:string		//可选,手机号码,工作圈内唯一 。如果account字段中mobile和email都为空，那这个phone就必须有，
                                          否则创建账号不成功，如果account中的mobile字段存在，则优先以mobile作为账号，phone字段忽略。
                                          建议phone和mobile只要其中一个传值即可
		phones:String       	//可选,其他手机号码,仅作为备注信息,多个电话以","(英文逗号)为分隔符,默认为空
		isHidePhone:String  	//可选,是否在通讯录中隐藏手机号码,0: 不隐藏; 1: 隐藏,默认为0
		email:string,		//可选,邮箱,仅作为备注信息,只支持一个邮箱,默认为空
		department:string	//可选,组织长名称,默认为"待分配"
		jobTitle:string		//可选,职位,默认为空
		gender:String		//可选,性别,0: 不确定; 1: 男; 2: 女,默认为0
                birthday:String         //可选,生日
                officePhone1:String     //可选,办公电话1
                officePhone2:String     //可选,办公电话2
		status:String		//可选,状态 0: 注销，1: 正常，2: 禁用,默认为1
                orgUserType:int         //可选,是否部门负责人,0表示普通用户，1表示部门负责人
                contact:String          //自定义的联系方式，可以存储公司自定义的一些个人信息，比如短号、工号等，jsonarray格式。contact是公有信息，
                                          包括电话，邮箱以及其他三类，contact是jsonarray格式，每个必须有name,type,value三个属性，
                                          具体格式:[{“name”:”电话”，“type”:”P”, “value”:”13800000000”},{"name":"邮箱1","type":"E","value":"123aaa@abc.com"}...]，
                                          其中name是自定义属性的名称，type是类型，type值只有P,E,O三种类型，分别表示手机号，邮箱和其他，value是对应的值
                regSource:String        //用户来源，如K3OA则对应"K3OA",EAS对应"EAS",K/3对应"K/3",KIS对应"KIS",微信对应"wechat"，S-HR对应"sHR"
	},…]
}</pre>

<p>
完整JSON串示例：
</p>
<pre class="code">{
	"eid":"30085",
	"persons":[{"name":"YINHONGJUN",
                  "photoUrl":"",
                  "account":{
		        "mobile":”13750158xxx”,
		        "email":"xxx@163.com",
		        "password":”123456”
		  }，
                  "phone":"13750158xxx",
                  "phones":"",
                  "isHidePhone":0,
                  "email":"xxx@163.com",
                  "department":"研发中心\移动平台产品部\开发部",
                  "jobTitle":"开发工程师",
                  "gender":1,
                  "birthday:"2012-12-12",
                  "officePhone1:"075586072xxx",
                  "officePhone2:"6088x",
                  "status":1,
                  "contact":[{
		       "name":"电话",
		       "type":"P",
		       "value":"13800000000"		
		    }]  
                  }],
                  "regSource":"K3OA"
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data格式:
</p>
<pre class="code">{ 
	[{
                openId:String,          //openId
		msgId:string,		//如果创建成功，则与openId相同值，不成功，则是手机号
		msgCode:int		//消息码
		msg:string		//消息
	},…]	
}</pre>

</div>

<h2 class="sectionedit27" id="更新人员信息">4.6、更新人员信息</h2>
<div class="level2">
<div class="wrap_center wrap_round wrap_important plugin_wrap" style="width:80%;">
<p>
V2.0更新人员接口已拆分为更新人员信息接口及更新人员组织，请注意更新人员信息接口有以下主要修订内容：
</p>
<ol>
<li class="level1"><div class="li"> 不再支持人员的新增，新增人员请使用<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#新增人员" title="open:组织人员同步 ↵" class="wikilink1">4.5、新增人员</a>接口;</div>
</li>
<li class="level1"><div class="li"> 不再支持电话的更改，电话的变更须由用户自行在移动客户端中操作;</div>
</li>
<li class="level1"><div class="li"> 不再支持组织的新增、更改，组织的变更须使用<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#更新人员组织" title="open:组织人员同步 ↵" class="wikilink1">4.7、更新人员组织</a>接口</div>
</li>
</ol>

<p>
V2.1更新人员接口已不再支持状态的更改，状态的变更请使用<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#更新人员状态" title="open:组织人员同步 ↵" class="wikilink1">4.8、更新人员状态</a>接口;
</p>
</div>
<p>
描述: 根据openId更新人员信息，openId字段必填，其他字段至少有一项不能为空，每次更新数不能超过1000条
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/person/updateInfo
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	eid:string			//不必须，如果没有，则以外面的eid参数为准
	persons:[{		    	//必填,人员列表
		openId:string		//必填,人员的openId，获取方式参见 [4.10、查询全部人员信息]
		name:string,		//可选,姓名
		photoUrl:string,	//可选,头像URL
		phones:string		//可选,除phone外的其他手机号码
		isHidePhone:String      //可选,是否在通讯录中隐藏手机号码
		jobTitle:string		//可选,职位
		gender:int		//可选,性别
                birthday:String         //可选,生日
                officePhone1:String     //可选,办公电话1
                officePhone2:String     //可选,办公电话2
                contacts:[{
		     name: String,
		     type:String,
		     value:String		
		}...]                   // 自定义的联系方式
	},…]
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data格式:
</p>
<pre class="code">{ 
	[{
		msgId:string,		//人员的openId
		msgCode:int		//消息码
		msg:string		//消息
	},…]	
}</pre>

<p>
<strong>注意</strong>：
需要更新的字段请将对应的key-value对传过来，不用更新的字段，请不要传递对应的key。
</p>

<p>
举个例子，传递：”jobTitle”:”” 将导致职称被清空（而不是保持职称不修改）。
</p>

</div>

<h2 class="sectionedit30" id="更新人员组织">4.7、更新人员组织</h2>
<div class="level2">

<p>
描述: 根据openId更新人员组织，每次更新数不能超过1000条
</p>
<div class="wrap_center wrap_round wrap_tip plugin_wrap" style="width:80%;">
<p>
更新人员组织是V2.0定义的新接口
</p>
</div>
<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/person/updateDept
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	eid:string			//不必须，如果没有，则以外面的eid参数为准
	persons:[{		    	//必填,人员列表
		openId:string		//必填,人员的openId,人员必须在职
		department:string,	//必填,新的组织长名称,组织须已存在
	},…]
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data格式:
</p>
<pre class="code">{ 
	[{
		msgId:string,		//人员的openId
		msgCode:int		//消息码
		msg:string		//消息
	},…]	
}</pre>

</div>

<h2 class="sectionedit33" id="更新人员状态">4.8、更新人员状态</h2>
<div class="level2">

<p>
描述: 根据openId更新人员状态，每次更新数不能超过1000条
</p>
<div class="wrap_center wrap_round wrap_tip plugin_wrap" style="width:80%;">
<p>
更新人员状态是V2.1定义的新接口
</p>
</div>
<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/person/updateStatus
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	eid:string			//不必须，如果没有，则以外面的eid参数为准
	persons:[{		    	//必填,人员列表
		openId:string		//必填,人员的openId
		type:string,		//必填,详见type类型值说明表
	},…]
}</pre>
<div class="table sectionedit36"><table class="inline">
	<tbody><tr class="row0">
		<th class="col0 centeralign">  type类型值  </th><th class="col1 centeralign">  业务说明  </th><th class="col2 centeralign">  变更前人员status  </th><th class="col3 centeralign">  变更后人员status  </th><th class="col4 centeralign">  接口支持性  </th>
	</tr>
	<tr class="row1">
		<td class="col0 centeralign">  1  </td><td class="col1">人员离职</td><td class="col2 centeralign">  1:正常  </td><td class="col3 centeralign">  0:注销  </td><td class="col4">有效，接口已支持此操作</td>
	</tr>
	<tr class="row2">
		<td class="col0 centeralign">  2  </td><td class="col1">人员恢复</td><td class="col2 centeralign">  0:注销  </td><td class="col3 centeralign">  1:正常  </td><td class="col4">无效，目前接口暂不支持此操作</td>
	</tr>
	<tr class="row3">
		<td class="col0 centeralign">  3  </td><td class="col1">人员禁用</td><td class="col2 centeralign">  1:正常  </td><td class="col3 centeralign">  2:禁用  </td><td class="col4">无效，目前接口暂不支持此操作</td>
	</tr>
	<tr class="row4">
		<td class="col0 centeralign">  4  </td><td class="col1">人员启用</td><td class="col2 centeralign">  2:禁用  </td><td class="col3 centeralign">  1:正常  </td><td class="col4">无效，目前接口暂不支持此操作</td>
	</tr>
</tbody></table></div>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data格式:
</p>
<pre class="code">{ 
	[{
		msgId:string,		//人员的openId
		msgCode:int		//消息码
		msg:string		//消息
	},…]	
}</pre>

</div>

<h2 class="sectionedit37" id="删除人员">4.9、删除人员</h2>
<div class="level2">
<div class="wrap_center wrap_round wrap_important plugin_wrap" style="width:80%;">
<p>
V2.0删除人员接口已经修订，请注意以下修改内容：
</p>
<ol>
<li class="level1"><div class="li"> 不再支持按电话删除人员</div>
</li>
</ol>
</div>
<p>
描述: 删除人员，根据openId删除人员，每次删除记录不能超过1000条
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/person/delete
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{		
	eid:string			//不必须，如果没有，则以外面的eid参数为准
	openIds:[string,…]		//必填,人员的openId数组
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data格式:
</p>
<pre class="code">{ [{
	msgId:string,			//人员的openId
	msgCode:int			//消息码
	msg:string			//消息
},…]	
}</pre>

</div>

<h2 class="sectionedit40" id="查询全部人员信息">4.10、查询全部人员信息</h2>
<div class="level2">

<p>
描述: 查询全部人员信息，查询使用分页机制，每次查询总数不能超过1000条
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/person/getall
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	eid:string			//不必须，如果没有，则以外面的eid参数为准
	begin:int			//可选,默认0
	count:int			//可选,默认1000
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data格式:
</p>
<pre class="code">[{		    			//人员列表
	openId:string			//人员的openid
	name:string,			//姓名
	photoUrl:string,	    	//头像URL
	phone:string,			//手机号码
	phones:string			//其他手机号码
	isHidePhone:String  		//是否在通讯录中隐藏手机号码,0: 不隐藏; 1: 隐藏,默认为0
	email:string,			//邮箱
	department:string		//组织长名称
	jobTitle:string			//职位
	gender:int 			//性别,0: 不确定; 1: 男; 2: 女
	status:int 			//状态 0: 注销，1: 正常，2: 禁用
},…]</pre>

</div>

<h2 class="sectionedit41" id="查询已更新人员信息">4.11、查询已更新人员信息</h2>
<div class="level2">

<p>
描述: 查询某个时点后有更新的人员信息,更新的信息包括个人信息以及状态信息（正常状态变为离职状态）
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/person/getAtTime
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	eid:string			//不必须，如果没有，则以外面的eid参数为准
	time:String			//必填,查询时点，格式：“2014-08-02 01:40:38”
	begin:int			//可选,默认0
	count:int			//可选,默认1000
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data格式:
</p>
<pre class="code">[{		    			//人员列表
	openId:string			//人员的openid
	name:string,			//姓名
	photoUrl:string,	    	//头像URL
	phone:string,			//手机号码
	phones:string			//其他手机号码
	isHidePhone:String  		//是否在通讯录中隐藏手机号码,0: 不隐藏; 1: 隐藏,默认为0
	email:string,			//邮箱
	department:string		//组织长名称
	jobTitle:string			//职位
	gender:int 			//性别,0: 不确定; 1: 男; 2: 女
	status:int 			//状态 0: 注销，1: 正常，2: 禁用
},…]</pre>

</div>

<h2 class="sectionedit42" id="查询指定人员信息">4.12、查询指定人员信息</h2>
<div class="level2">

<p>
描述: 根据openId或phone查询指定人员，每次不能超过1000条
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/person/get
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	eid:string			//注册号
	type:int			//0：手机号码，1：openId，默认0
	array:[string,…]		//手机号码或者openId数组
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data格式:
</p>
<pre class="code">[{		    			//人员列表
	openId:string			//人员的openid
	name:string,			//姓名
	photoUrl:string,	    	//头像URL
	phone:string,			//手机号码
	phones:string			//其他手机号码
	isHidePhone:String  		//是否在通讯录中隐藏手机号码,0: 不隐藏; 1: 隐藏,默认为0
	email:string,			//邮箱
	department:string		//组织长名称
	jobTitle:string			//职位
	gender:int 			//性别,0: 不确定; 1: 男; 2: 女
	status:int 			//状态 0: 注销，1: 正常，2: 禁用
},…]</pre>

</div>

<h2 class="sectionedit43" id="设置或取消管理员">4.13、设置或取消管理员</h2>
<div class="level2">

<p>
描述: 设置或者取消管理员身份。如果工作圈没有管理员，可以通过该接口设置一个管理员
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/company/setadmin
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	eid:string			//注册号,不必须，如果没有，则以外面的eid参数为准
        account:String                  //账号
	type:int			//0:取消 1:设置
}</pre>

</div>

<h2 class="sectionedit44" id="根据登陆账号和密码获取其是管理员的工作圈列表_开发者鉴权不包括该接口">4.14、根据登陆账号和密码获取其是管理员的工作圈列表（开发者鉴权不包括该接口）</h2>
<div class="level2">

<p>
描述: 根据登陆账号和密码获取其是管理员的工作圈列表
该接口跟其他接口有些区别，参数不需要加密，不需要用key。请求头信息中需要”Content-Type”:“application/json”。
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/person/getAdminCompany
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	userName:string			//账号
        password:String                  //密码（明文）
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>
</p>
<pre class="code">[{ 
	companyName:string	     //工作圈名字
        eid:String                  //工作圈eid
}，
{}......]</pre>

<p>
提示: 该url支持https访问。
</p>

</div>

<h2 class="sectionedit45" id="创建公司_工作圈">4.15、创建公司（工作圈）</h2>
<div class="level2">

<p>
描述: 创建公司（工作圈），该接口跟其他接口有些区别，参数不需要加密，不需要用key。请求头信息中需要”Content-Type”:“application/json”。
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/createCompany
</p>

<p>
方法: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	account:string	             // 必须 ，创建人账号
        name:String                  // 不必须 ，创建人昵称
        companyname：String          // 必须， 公司（工作圈）名称
        businessType：String         // 
        comment：String              //
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>
</p>
<pre class="code">{ 
    "eid": String //公司的eid
    "key": "MIICeAIBADANBgkqhkiG9w0BAQEFAASCAmIwggJeAgEAAoGBAK6j3ea4FruiiU1xgZh7EWZ2toEnuiXOGM0AMX1W8JGHz4YAKiYSPOI5wtp/SgtztOhX9UbIhxAY1keBaF5DCsF7lQDbxyFmUXoiMVFZVO2x8xYF4vx1imekEF3nuQc1p0FAbzM5sID8xnKU9upimLbCjvBd+uW5r44NJjhILZULAgMBAAECgYEApPun0aQNzdtCLQhTLxLsoEj8J025nKd0ZI6PMmLkyAdudKBJMUg/flSlETf5YpI/0NPvopwkhH+CR3EogQyC5jBCIM/K4KTCbH+poAek8vvRxt8Ax+dJ5wcN1+PE9j2VosewuXRv7LDgKiMpwI4A7aeCyw8qxLD/vjONUrG3gsECQQDgLh16GXStGSdiWPLmhw7VYyuk03Gz6PaUDesd/y+NQBvfEvO0GM2GyaO232zeZAXVMcyI2X6AxGazIcMjzAlrAkEAx22l+9WoIIhfYHdpmEhL2CfKDtyUoD0PGJkgSYjHRwlN8AOhOBNFH6gsDp1Prbz9NG53eezN+ETFcy8ZX5lq4QJAew/Vjpk6u2r7e7loXbP2KJ1v7+NCn4hbE5swXh8fc2Kl6ib1MQAMktlNza2IjexKZ2YW6Wi7UOR/nAYEoTn4UQJBAKBymEM3z491CH89M4igSdz7jjZMw4rz9QxOTkq7L9D4LGs5EGFkJ43jqKaNbAiU74ZahedjXQcslUspjpl6fiECQQCpHFhk7RzNbiv+kCmnXVyEviNL4zH5N/Jmq+FXYCWIUQ6RdwUhrDpm8V6mCY9TbMt13dXyzw+pq2QIDlbShGDP",   //公司的key
    "list": [
      {
        "msg": "数据导入或更新成功!",
        "openId": "558cb7dd60b2dec3213a03c4",
        "success": true
      }
    ]
}</pre>

<p>
<strong>返回字段说明</strong>：
</p>

<p>
eid，企业唯一id标识，在后续的所有接口调用中，都会用到该字段。
</p>

<p>
key, 企业私钥，它是经过Base64编码之后的key文件（因此，直接Base64解码就可以得到key文件对应的byte[]数组，这个数组可以直接调用3.3节中的restorePrivateKey()方法）
</p>

<p>
list, 管理员在当前工作圈的相关信息，openId管理员（创建者）的openId。
</p>

</div>

<h2 class="sectionedit46" id="设置登陆mcloud公司_工作圈_的密码">4.16、设置登陆mcloud公司（工作圈）的密码</h2>
<div class="level2">

<p>
描述: 设置登陆mcloud上工作圈的密码
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/company/setMcloudEidPwd
</p>

<p>
方式: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式:
</p>
<pre class="code">{ 
	password:String  // 密码（123456）。
}</pre>

<p>
<strong>注意，该接口的参数输入格式不是form格式而是json格式，如{“data”:”…加密后的data…”, “eid”:””,”nonce”:””}
且请求头信息（header）中需要带上”Content-Type”:“application/json”
加密的时候注意不能将url编码，即加密之后=,+等符号仍然是=，+,不能是编码后的%3d等</strong>
</p>

</div>

<h2 class="sectionedit47" id="批量设置部门负责人">4.17、批量设置部门负责人</h2>
<div class="level2">

<p>
描述: 设置部门负责人(<span style="color:red;font-size:150%;font-style:italic;">new</span>)
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/company/setOrgAdmins
</p>

<p>
方式: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式（传输过程中需要使用key加密）:
</p>
<pre class="code">[                 //单次同步，最多只允许1000条数据
          {
	     department: String  //部门长名称，格式："一级部门\二级部门\三级部门"，如 ： "研发中心\移动平台产品部\开发部"
             openId: String      //人员ID
             commitId: String    //唯一标识一条设置数据，建议使用自增序列（返回时，可用来判断一条记录是否成功）
          }
]</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data部分如下
</p>
<pre class="code">[
          {                     //只有在有失败数据时返回
             commitId: String   //提交ID
             errorMsg: String   //此处标识失败原因
          }
]</pre>

<p>
人员和部门必须已经存在才能设置成功。
</p>

</div>

<h2 class="sectionedit48" id="查询所有部门负责人">4.18、查询所有部门负责人</h2>
<div class="level2">

<p>
描述: 查询所有部门负责人(<span style="color:red;font-size:150%;font-style:italic;">new</span>)
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/company/queryOrgAdmins
</p>

<p>
方式: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式（传输过程中需要使用key加密）:
</p>
<pre class="code">{                                //分页查询部门负责人，每页限制最多返回1000条记录；count&gt;1000时，截断为1000。
	     begin: Integer      // 分页起始，比如：0
             count: Integer      // 单次查询条数，比如： 1000
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data部分如下
</p>
<pre class="code">[                                       //success为true时返回
          {                     
                 "openId": String,     //人员openId
                 "department": String, //所负责的部门长名称
          }
]</pre>

<p>
注意： 该接口只返回在职的部门负责人。
</p>

</div>

<h2 class="sectionedit49" id="批量删除部门负责人">4.19、批量删除部门负责人</h2>
<div class="level2">

<p>
描述: 批量删除部门负责人(<span style="color:red;font-size:150%;font-style:italic;">new</span>)
</p>

<p>
<abbr title="Uniform Resource Locator">URL</abbr>: openaccess/input/company/deleteOrgAdmins
</p>

<p>
方式: POST
</p>

<p>
输入: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输入格式" title="open:组织人员同步 ↵" class="wikilink1">3.1、输入格式</a>，具体data格式（传输过程中需要使用key加密）:
</p>
<pre class="code">{
 "deleteAll": Boolean,   //是否删除所有,默认值为false。该值传true时，表示删除所有部门负责人（此时list可以不传）；该值为false时，表示删除指定部门负责人，list字段必传。
 "list":[                //指定人员删除时，最多允许一次删除1000条记录
	    {
            "department":String,                 //部门长名称，格式："一级部门\二级部门\三级部门"，如 ： "研发中心\移动平台产品部\开发部"
            "openId":String,                     //人员ID
            "commitId":String                    //唯一标识一条数据，建议使用自增序列（返回时，可用来判断一条记录是否成功）
            }
  ]
}</pre>

<p>
输出: 参见<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#输出格式" title="open:组织人员同步 ↵" class="wikilink1">3.2、输出格式</a>，具体data部分如下
</p>
<pre class="code">[                                       //success为true时返回
          {
            "errorCode": Integer,          //错误码，注意：该字段可能不返回
            "commitId": String,            //提交ID
            "error": String                //具体错误消息
          }
]</pre>

<p>
注意： deleteAll参数会导致所有部门负责人被删除，请谨慎使用。data部分，特殊含义错误码说明：
</p>
<pre class="code">900014： "负责人不存在"</pre>

</div>

<h1 class="sectionedit50" id="错误码_消息码">5、错误码（消息码）</h1>
<div class="level1">

<p>
当前已使用的错误代码定义见下表，表中列出了代码号、适用接口以及该错误代码的意义。
</p>
<div class="table sectionedit51"><table class="inline">
	<tbody><tr class="row0">
		<th class="col0">错误码(消息码)</th><th class="col1"> 适用接口</th><th class="col2">描述</th><th class="col3">备注</th>
	</tr>
	<tr class="row1">
		<td class="col0">100</td><td class="col1">所有接口</td><td class="col2">成功</td><td class="col3"></td>
	</tr>
	<tr class="row2">
		<td class="col0">101</td><td class="col1">所有接口</td><td class="col2">重复请求</td><td class="col3"></td>
	</tr>
	<tr class="row3">
		<td class="col0">102</td><td class="col1">所有接口</td><td class="col2">eid为空</td><td class="col3"></td>
	</tr>
	<tr class="row4">
		<td class="col0">103</td><td class="col1">所有接口</td><td class="col2">非法eid，未在mcloud注册</td><td class="col3"></td>
	</tr>
	<tr class="row5">
		<td class="col0">104</td><td class="col1">所有接口</td><td class="col2">数据加密错误</td><td class="col3"></td>
	</tr>
	<tr class="row6">
		<td class="col0">105</td><td class="col1">所有接口</td><td class="col2">导入数据量超标</td><td class="col3"></td>
	</tr>
	<tr class="row7">
		<td class="col0">106</td><td class="col1">所有接口</td><td class="col2">业务异常，需查看详情</td><td class="col3"></td>
	</tr>
	<tr class="row8">
		<td class="col0">107</td><td class="col1">所有接口</td><td class="col2">数据库异常</td><td class="col3"></td>
	</tr>
	<tr class="row9">
		<td class="col0">108</td><td class="col1">所有接口</td><td class="col2">数据为空</td><td class="col3">导入，更新，删除</td>
	</tr>
	<tr class="row10">
		<td class="col0">109</td><td class="col1">所有接口</td><td class="col2">Data格式错误</td><td class="col3"></td>
	</tr>
	<tr class="row11">
		<td class="col0">110</td><td class="col1">所有接口</td><td class="col2">Data中eid与参数中eid不同</td><td class="col3"></td>
	</tr>
	<tr class="row12">
		<td class="col0">111</td><td class="col1">所有接口</td><td class="col2">openId关联失败</td><td class="col3"></td>
	</tr>
	<tr class="row13">
		<td class="col0">201</td><td class="col1">所有接口</td><td class="col2">导入组织已存在</td><td class="col3"></td>
	</tr>
	<tr class="row14">
		<td class="col0">202</td><td class="col1">所有接口</td><td class="col2">组织导入成功</td><td class="col3"></td>
	</tr>
	<tr class="row15">
		<td class="col0">203</td><td class="col1">所有接口</td><td class="col2">更新组织ID为空</td><td class="col3"></td>
	</tr>
	<tr class="row16">
		<td class="col0">204</td><td class="col1">所有接口</td><td class="col2">更新组织成功</td><td class="col3"></td>
	</tr>
	<tr class="row17">
		<td class="col0">205</td><td class="col1">所有接口</td><td class="col2">删除组织成功</td><td class="col3"></td>
	</tr>
	<tr class="row18">
		<td class="col0">206</td><td class="col1">所有接口</td><td class="col2">导入人员已存在</td><td class="col3"></td>
	</tr>
	<tr class="row19">
		<td class="col0">207</td><td class="col1">所有接口</td><td class="col2">参数导入人员无对应组织</td><td class="col3"></td>
	</tr>
	<tr class="row20">
		<td class="col0">208</td><td class="col1">所有接口</td><td class="col2">数据中心导入人员无对应组织</td><td class="col3"></td>
	</tr>
	<tr class="row21">
		<td class="col0">209</td><td class="col1">所有接口</td><td class="col2">人员导入成功</td><td class="col3"></td>
	</tr>
	<tr class="row22">
		<td class="col0">210</td><td class="col1">所有接口</td><td class="col2">需更新人员不存在</td><td class="col3"></td>
	</tr>
	<tr class="row23">
		<td class="col0">211</td><td class="col1">所有接口</td><td class="col2">人员无对应关系，无法更新关系</td><td class="col3"></td>
	</tr>
	<tr class="row24">
		<td class="col0">212</td><td class="col1">所有接口</td><td class="col2">更新组织ID为空</td><td class="col3"></td>
	</tr>
	<tr class="row25">
		<td class="col0">213</td><td class="col1">所有接口</td><td class="col2">人员更新成功</td><td class="col3"></td>
	</tr>
	<tr class="row26">
		<td class="col0">214</td><td class="col1">所有接口</td><td class="col2">人员删除成功</td><td class="col3"></td>
	</tr>
	<tr class="row27">
		<td class="col0">215</td><td class="col1">所有接口</td><td class="col2">用户名，用户ID，人员ID，saltType不能为空</td><td class="col3"></td>
	</tr>
	<tr class="row28">
		<td class="col0">216</td><td class="col1">所有接口</td><td class="col2">关系已存在，关系更新成功</td><td class="col3"></td>
	</tr>
	<tr class="row29">
		<td class="col0">217</td><td class="col1">所有接口</td><td class="col2">关系导入成功</td><td class="col3"></td>
	</tr>
	<tr class="row30">
		<td class="col0">218</td><td class="col1">所有接口</td><td class="col2">人员不存在</td><td class="col3"></td>
	</tr>
	<tr class="row31">
		<td class="col0">219</td><td class="col1">所有接口</td><td class="col2">手机号码已经存在，不能重复</td><td class="col3"></td>
	</tr>
	<tr class="row32">
		<td class="col0">220</td><td class="col1">所有接口</td><td class="col2">openId不存在</td><td class="col3"></td>
	</tr>
	<tr class="row33">
		<td class="col0">221</td><td class="col1">所有接口</td><td class="col2">原组织长名称不存在</td><td class="col3"></td>
	</tr>
	<tr class="row34">
		<td class="col0">222</td><td class="col1">所有接口</td><td class="col2">组织长名称修改成功</td><td class="col3"></td>
	</tr>
	<tr class="row35">
		<td class="col0">223</td><td class="col1">所有接口</td><td class="col2">组织长名称修改失败</td><td class="col3"></td>
	</tr>
	<tr class="row36">
		<td class="col0">224</td><td class="col1">所有接口</td><td class="col2">原部门有下级组织无法修改</td><td class="col3"></td>
	</tr>
	<tr class="row37">
		<td class="col0">225</td><td class="col1">所有接口</td><td class="col2">手机号码格式不正确</td><td class="col3"></td>
	</tr>
	<tr class="row38">
		<td class="col0">226</td><td class="col1">所有接口</td><td class="col2">手机号码重复</td><td class="col3"></td>
	</tr>
	<tr class="row39">
		<td class="col0">227</td><td class="col1">所有接口</td><td class="col2">openId&amp;phone为空</td><td class="col3"></td>
	</tr>
	<tr class="row40">
		<td class="col0">228</td><td class="col1">所有接口</td><td class="col2">原组织长名称为公司名称无法修改</td><td class="col3"></td>
	</tr>
	<tr class="row41">
		<td class="col0">229</td><td class="col1">所有接口</td><td class="col2">新旧手机都已被激活无法更改手机号码</td><td class="col3">已作废</td>
	</tr>
	<tr class="row42">
		<td class="col0">230</td><td class="col1">所有接口</td><td class="col2">移动人员，组织不存在</td><td class="col3"></td>
	</tr>
	<tr class="row43">
		<td class="col0">231</td><td class="col1">所有接口</td><td class="col2">移动人员失败</td><td class="col3"></td>
	</tr>
	<tr class="row44">
		<td class="col0">232</td><td class="col1">所有接口</td><td class="col2">人员疑似重复</td><td class="col3"></td>
	</tr>
	<tr class="row45">
		<td class="col0">233</td><td class="col1">所有接口</td><td class="col2">不支持修改的人员状态类型</td><td class="col3"></td>
	</tr>
	<tr class="row46">
		<td class="col0">234</td><td class="col1">所有接口</td><td class="col2">人员当前状态和修改类型不匹配</td><td class="col3"></td>
	</tr>
	<tr class="row47">
		<td class="col0">235</td><td class="col1">所有接口</td><td class="col2">修改状态，type字段不能为空</td><td class="col3"></td>
	</tr>
	<tr class="row48">
		<td class="col0">236</td><td class="col1">所有接口</td><td class="col2">状态不为1（在职）的人员，不让修改信息</td><td class="col3"></td>
	</tr>
	<tr class="row49">
		<td class="col0">237</td><td class="col1">所有接口</td><td class="col2">开通ERP同步权限的企业，组织和人员不允许修改</td><td class="col3"></td>
	</tr>
	<tr class="row50">
		<td class="col0">300</td><td class="col1">所有接口</td><td class="col2">没有权限访问</td><td class="col3"></td>
	</tr>
	<tr class="row51">
		<td class="col0">301</td><td class="col1">所有接口</td><td class="col2">访问权限已到期</td><td class="col3"></td>
	</tr>
</tbody></table></div>

</div>

<h1 class="sectionedit52" id="版本修订记录">6、版本修订记录</h1>
<div class="level1">

<p>
V2.6
</p>
<ul>
<li class="level1"><div class="li"> 修订了”根据账号和密码获取其是管理员的工作圈列表”接口</div>
</li>
</ul>

<p>
V2.5
</p>
<ul>
<li class="level1"><div class="li"> 修订了”新增人员”接口，新增人员参数中新增了一个regSource属性，意思为用户来源</div>
</li>
</ul>

<p>
V2.4
</p>
<ul>
<li class="level1"><div class="li"> 修订了”设置或取消管理员”接口</div>
</li>
</ul>

<p>
V2.3
</p>
<ul>
<li class="level1"><div class="li"> 修订了”新增人员”和”更新人员信息”接口，增补了”生日”、”办公电话1”、”办公电话2”字段</div>
</li>
</ul>

<p>
V2.2
</p>
<ul>
<li class="level1"><div class="li"> 定义了”查询已更新人员信息”接口</div>
</li>
</ul>

<p>
V2.1
</p>
<ul>
<li class="level1"><div class="li"> 定义了”更新人员状态”接口</div>
</li>
<li class="level1"><div class="li"> 修订了”更新人员信息”接口，不再支持更改状态</div>
</li>
</ul>

<p>
V2.0
</p>
<ul>
<li class="level1"><div class="li"> 修订了部分文字描述：”企业”更改为”工作圈”、”部门”更改为”组织”、”职员”更改为”人员”</div>
</li>
<li class="level1"><div class="li"> 定义了网络传输规范</div>
</li>
<li class="level1"><div class="li"> 定义了”新增组织”接口</div>
</li>
<li class="level1"><div class="li"> 定义了”新增人员”接口</div>
</li>
<li class="level1"><div class="li"> 修订了”更新职员”接口，拆分为”更新人员信息”接口及”更新人员部门”接口，不再支持新增人员、新增与修改组织、更改电话</div>
</li>
<li class="level1"><div class="li"> 定义了”更新人员部门”接口</div>
</li>
<li class="level1"><div class="li"> 定义了”查询全部组织信息”接口</div>
</li>
<li class="level1"><div class="li"> 修订了”查询人员信息”接口，增补了部分字段</div>
</li>
<li class="level1"><div class="li"> 修订了其他规范细节</div>
</li>
</ul>

<p>
V1.0
</p>
<ul>
<li class="level1"><div class="li"> 初始化API接口规范</div>
</li>
<li class="level1"><div class="li"> 定义了输入输出格式规范</div>
</li>
<li class="level1"><div class="li"> 定义了”更新职员”接口</div>
</li>
<li class="level1"><div class="li"> 定义了”删除职员”接口</div>
</li>
<li class="level1"><div class="li"> 定义了”更新部门”接口</div>
</li>
<li class="level1"><div class="li"> 定义了”删除部门”接口</div>
</li>
<li class="level1"><div class="li"> 定义了”查询全部职员信息”接口</div>
</li>
<li class="level1"><div class="li"> 定义了”查询职员信息”接口</div>
</li>
<li class="level1"><div class="li"> 定义了”错误码(消息码)”			</div>
</li>
</ul>

</div>
<div class="comment_wrapper" id="comment_wrapper">
  <h2><a name="discussion__section" id="discussion__section">
    评论
  </a></h2>
  <div class="level2 hfeed">

        <div class="comment_form">
          <form id="discussion__comment_form" method="post" action="http://open.kdweibo.com/wiki/doku.php" accept-charset="utf-8">
            <div class="no">
              <input type="hidden" name="id" value="open:组织人员同步">
              <input type="hidden" name="do" value="show">
              <input type="hidden" name="comment" value="add">
                      <input type="hidden" name="reply" value="">
                      <input type="hidden" name="user" value="10.63.2.167,124.119.61.114">
              <div class="comment_name">
                <label class="block" for="discussion__comment_name">
                  <span>全名:</span>
                  <input type="text" class="edit" name="name" id="discussion__comment_name" size="50" tabindex="1" value="">
                </label>
              </div>
              <div class="comment_mail">
                <label class="block" for="discussion__comment_mail">
                  <span>E-Mail:</span>
                  <input type="text" class="edit" name="mail" id="discussion__comment_mail" size="50" tabindex="2" value="">
                </label>
              </div>
                        <div class="comment_text">
                  请输入您的评论:                 
                  <!-- Fix for disable the toolbar when wikisyntaxok is set to false. See discussion's script.jss -->
                                      <div id="discussion__comment_toolbar_disabled">
                                  </div>
                <textarea class="edit" name="text" cols="80" rows="10" id="discussion__comment_text" tabindex="5"></textarea>
              </div>
        <div id="plugin__captcha_wrapper" style="display: none;"><input type="hidden" name="6618a04d26bfff9d330950124de5ace3" value="BODccZgtxO6dEbwMB7v9yIaJutnKN7L5Q+hiBpDcHT0="><label for="plugin__captcha">请在输入框中填入验证码以证明您不是机器人。</label> <span id="plugin__captcha_code">U&nbsp;G V A
U</span> <input type="text" size="5" name="ce0348cbaea49296fb0a2081629e15f4" class="edit"> <label class="no">请将此区域留空：<input type="text" name="03391c0f19b085af6179d3ca7e7af748"></label></div>              <input class="button comment_submit" id="discussion__btn_submit" type="submit" name="submit" accesskey="s" value="保存" title="保存 [S]" tabindex="7">
              <input class="button comment_preview_button" id="discussion__btn_preview" type="button" name="preview" accesskey="p" value="预览" title="预览 [P]">

        
              <div class="clearer"></div>
              <div id="discussion__comment_preview">&nbsp;</div>
            </div>
          </form>
        </div>
          </div>
</div>

<script type="text/javascript">
  SyntaxHighlighter.autoloader(
    'applescript /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushAppleScript.js',
    'actionscript3 as3 /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushAS3.js',
    'bash shell /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushBash.js',
    'coldfusion cf /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushColdFusion.js',
    'cpp c /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushCpp.js',
    'c# c-sharp csharp /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushCSharp.js',
    'css /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushCss.js',
    'delphi pascal /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushDelphi.js',
    'diff patch pas /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushDiff.js',
    'erl erlang /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushErlang.js',
    'groovy /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushGroovy.js',
    'java /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushJava.js',
    'jfx javafx /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushJavaFX.js',
    'js jscript javascript /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushJScript.js',
    'perl pl /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushPerl.js',
    'php /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushPhp.js',
    'text plain /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushPlain.js',
    'ps powershell /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushPowerShell.js',
    'py python /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushPython.js',
    'ruby rails ror rb /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushRuby.js',
    'sass scss /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushSass.js',
    'scala /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushScala.js',
    'sql /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushSql.js',
    'vb vbnet /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushVb.js',
    'xml xhtml xslt html /wiki/lib/plugins/syntaxhighlighter3/sxh3/scripts/shBrushXml.js'
  );
  SyntaxHighlighter.all();
</script>

<!-- end rendered page content -->
<div class="clearer"></div>


            </div>
        </div>
        <!-- end left col -->
        
        <!-- start right col -->
        <div id="tmpl_sidebar">
            
            <div class="sidebarnav">

<p>


</p><ul>
<li class="level1"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E9%A6%96%E9%A1%B5" class="wikilink1" title="首页">首页</a></div>
<ul>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=index:%E5%BC%80%E6%94%BE%E5%B9%B3%E5%8F%B0%E6%A6%82%E8%BF%B0" class="wikilink1" title="首页:开放平台概述" target="_blank">开放平台概述</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E9%A6%96%E9%A1%B5#轻应用接入流程" class="wikilink1" title="首页:轻应用接入流程">轻应用接入流程</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E9%A6%96%E9%A1%B5#轻应用接入流程" class="wikilink1" title="首页:新手轻应用接入指引">新手轻应用指引</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=index:api%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3" class="wikilink1" title="首页:api开发文档" target="_blank">API开发文档</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=index:%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98" class="wikilink1" title="首页:常见问题" target="_blank">常见问题</a></div>
</li>
</ul>
</li>
<li class="level1"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E6%96%B0%E6%89%8B%E6%8C%87%E5%8D%97" class="wikilink1" title="新手指南">新手指南</a></div>
<ul>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E6%96%B0%E6%89%8B%E6%8C%87%E5%8D%97:%E8%BD%BB%E5%BA%94%E7%94%A8%E6%A6%82%E5%BF%B5" class="wikilink1" title="新手指南:轻应用概念">轻应用概念</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E9%A6%96%E9%A1%B5#轻应用接入流程" class="wikilink1" title="轻应用接入流程">轻应用接入流程</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=index:%E5%BC%80%E5%8F%91%E8%80%85%E6%B3%A8%E5%86%8C%E6%8C%87%E5%8D%97" class="wikilink1" title="开发者注册指南">开发者注册指南</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98:%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98-%E8%AF%A6%E6%83%85%E9%A1%B5#企业数据如何接入云之家？" class="wikilink1" title="新手指南:企业数据接入指南">企业数据接入指南</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E6%96%B0%E6%89%8B%E6%8C%87%E5%8D%97:%E8%BD%BB%E5%BA%94%E7%94%A8%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97" class="wikilink1" title="新手指南:轻应用接入指南">轻应用接入指南</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E6%96%B0%E6%89%8B%E6%8C%87%E5%8D%97:%E8%BD%BB%E5%BA%94%E7%94%A8%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97" class="wikilink1" title="新手指南:轻应用开发指南">轻应用开发指南</a></div>
</li>
</ul>
</li>
<li class="level1"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3" class="wikilink1" title="开发文档">开发文档</a></div>
<ul>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=index:api%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3" class="wikilink1" title="index:api开发文档">API文档</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3:sdk%E4%B8%8B%E8%BD%BD" class="wikilink1" title="开发文档:sdk下载">SDK下载</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3:%E6%BA%90%E7%A0%81%E4%B8%8E%E7%A4%BA%E4%BE%8B" class="wikilink1" title="开发文档:源码与示例">源码与示例</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3:ui%E8%AE%BE%E8%AE%A1%E5%8F%8A%E5%BC%80%E5%8F%91%E8%A7%84%E8%8C%83" class="wikilink1" title="开发文档:ui设计及开发规范">UI设计及开发规范</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3:%E5%BC%80%E5%8F%91%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98" class="wikilink1" title="开发文档:开发常见问题">开发常见问题</a></div>
</li><li class="level2"><div class="li"> <a href="http://open.yunzhijia.com/wiki/doku.php?id=%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3:%E5%89%8D%E7%AB%AF%E8%B5%84%E6%BA%90" class="wikilink1" title="开发文档:前端资源">前端资源</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3:2016%E4%BA%91%E4%B9%8B%E5%AE%B6%E5%BC%80%E5%8F%91%E8%80%85%E5%A4%A7%E4%BC%9A" class="wikilink1" title="开发文档:2016云之家开发者大会课件">开发者大会课件</a></div>
</li>
</ul>
</li>
<li class="level1"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E6%9C%8D%E5%8A%A1%E4%B8%8E%E6%94%AF%E6%8C%81" class="wikilink1" title="服务与支持">服务与支持</a></div>
<ul>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E6%9C%8D%E5%8A%A1%E4%B8%8E%E6%94%AF%E6%8C%81:%E5%AE%A2%E6%9C%8D%E6%8C%87%E5%8D%97" class="wikilink1" title="服务与支持:客服指南">客服指南</a></div>
</li>
<li class="level2"><div class="li"> <a href="http://open.kdweibo.com/wiki/doku.php?id=%E6%9C%8D%E5%8A%A1%E4%B8%8E%E6%94%AF%E6%8C%81:%E5%BC%80%E5%8F%91%E8%80%85%E8%AE%BA%E5%9D%9B" class="wikilink1" title="服务与支持:开发者论坛">开发者论坛</a></div>
</li>
</ul>
</li>
</ul>

<p></p>
            </div>

			
			
            <div id="youarehere" class="sidebarbox">
                <h5 class="hspec">您的足迹</h5>
                <div class="level1"> <span class="bcsep">•</span> <bdi><a href="http://open.kdweibo.com/wiki/doku.php?id=%E9%A6%96%E9%A1%B5" class="breadcrumbs" title="首页">首页</a></bdi> <span class="bcsep">•</span> <bdi><a href="http://open.kdweibo.com/wiki/doku.php?id=%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98:%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98-%E8%AF%A6%E6%83%85%E9%A1%B5" class="breadcrumbs" title="常见问题:常见问题-详情页">常见问题-详情页</a></bdi> <span class="bcsep">•</span> <span class="curid"><bdi><a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5" class="breadcrumbs" title="open:组织人员同步">组织人员同步</a></bdi></span>
                </div>
            </div>

            
            <div id="search" class="sidebarbox">
                <h5 class="hspec">搜索</h5>
                <div class="level1"><form action="http://open.kdweibo.com/wiki/doku.php?id=%E9%A6%96%E9%A1%B5" accept-charset="utf-8" class="search" id="dw__search" method="get" role="search"><div class="no"><input type="hidden" name="do" value="search"><input type="text" id="qsearch__in" accesskey="f" name="id" class="edit" title="[F]"><input type="submit" value="搜索" class="button" title="搜索"><div id="qsearch__out" class="ajax_qsearch JSpopup" style="display: none;"></div></div></form>
                </div>
            </div>

            
            <div class="sidebarbox" id="qrcode">
                <h5 class="hspec">二维码: 本页URL地址</h5>
                <div class="level1"><span class="qrcode"><a href="http://goqr.me/" target="_blank"><img src="./open 组织人员同步 - 云之家·开放平台_files/saved_resource" alt="二维码: 本页URL地址 open:组织人员同步 (生成本页)" title="本页的二维码(便于手机扫描)"></a></span><p class="qrsrc"><a href="http://goqr.me/" target="_blank">QR Code</a> by <a href="http://qrserver.com/" target="_blank">QR-Server</a></p></div>
            </div>


            <div id="licenseinfo">
                
            </div>


            <div class="clearer"></div>
        </div>
        <!-- end right col -->
        <div class="clearer"></div>

        <div id="tmpl_footer">
            <div id="tmpl_footer_actlinksleft">
                [&nbsp;<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#dokuwiki__top" class="action top" accesskey="t" rel="nofollow" title="回到顶部 [T]">回到顶部</a>&nbsp;|&nbsp;<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5&do=index" class="action index" accesskey="x" rel="nofollow" title="网站地图 [X]">网站地图</a>&nbsp;]            </div>
            <div id="tmpl_footer_actlinksright">
                [&nbsp;<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5&do=login&sectok=e83ab87694aac7825af226694f2efc93" class="action login" rel="nofollow" title="登录">登录</a>&nbsp;|&nbsp;<a href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5&do=revisions" class="action revs" accesskey="o" rel="nofollow" title="修订记录 [O]">修订记录</a>&nbsp;]            </div>
            <div class="clearer"></div>
            <div id="tmpl_footer_metainfo">
                <a href="http://andreas-haerter.com/" target="_blank" rel="nofollow">mnml-blog</a> on <a href="http://www.dokuwiki.org/" target="_blank">DW</a> under the hood
            </div>
        </div>

    </div>
    <!-- end main content area -->
    <div class="clearer"></div>
    <img src="./open 组织人员同步 - 云之家·开放平台_files/indexer.php" width="2" height="1" alt="">
</div>



<a id="ext_btt" href="http://open.kdweibo.com/wiki/doku.php?id=open:%E7%BB%84%E7%BB%87%E4%BA%BA%E5%91%98%E5%90%8C%E6%AD%A5#"><img src="chrome-extension://alpoeaffjpfnidlkiidponkainlnfhnl/images/icon.png"></a></body></html>